<!DOCTYPE HTML PUBLIC "-//ORA//DTD CD HTML 3.2//EN">
<HTML>
<HEAD>
<TITLE>[Chapter 24] 24.47 java.io.OutputStreamWriter (JDK 1.1)</TITLE>
<META NAME="author" CONTENT="David Flanagan">
<META NAME="date" CONTENT="Thu Jul 31 16:22:38 1997">
<META NAME="form" CONTENT="html">
<META NAME="metadata" CONTENT="dublincore.0.1">
<META NAME="objecttype" CONTENT="book part">
<META NAME="otheragent" CONTENT="gmat dbtohtml">
<META NAME="publisher" CONTENT="O'Reilly &amp; Associates, Inc.">
<META NAME="source" CONTENT="SGML">
<META NAME="subject" CONTENT="Java">
<META NAME="title" CONTENT="Java in a Nutshell">
<META HTTP-EQUIV="Content-Script-Type" CONTENT="text/javascript">
</HEAD>
<body vlink="#551a8b" alink="#ff0000" text="#000000" bgcolor="#FFFFFF" link="#0000ee">

<DIV CLASS=htmlnav>
<H1><a href='index.htm'><IMG SRC="gifs/smbanner.gif"
     ALT="Java in a Nutshell" border=0></a></H1>
<table width=515 border=0 cellpadding=0 cellspacing=0>
<tr>
<td width=172 align=left valign=top><A HREF="ch24_46.htm"><IMG SRC="gifs/txtpreva.gif" ALT="Previous" border=0></A></td>
<td width=171 align=center valign=top><B><FONT FACE="ARIEL,HELVETICA,HELV,SANSERIF" SIZE="-1">Chapter 24<br>The java.io Package</FONT></B></TD>
<td width=172 align=right valign=top><A HREF="ch24_48.htm"><IMG SRC="gifs/txtnexta.gif" ALT="Next" border=0></A></td>
</tr>
</table>

&nbsp;
<hr align=left width=515>
</DIV>
<DIV CLASS=sect1>
<h2 CLASS=sect1><A CLASS="TITLE" NAME="JNUT2-CH-24-SECT-47">24.47 java.io.OutputStreamWriter (JDK 1.1)</A></h2>

<DIV CLASS=sect2>
<h3 CLASS=sect2><A CLASS="TITLE" NAME="JNUT2-CH-24-SECT-47.1"></A></h3>
</DIV>

<P CLASS=para>
This class is a character output stream that uses a byte
output stream as the destination for its data: when
characters are written to an <tt CLASS=literal>OutputStreamWriter</tt>, it
translates them into bytes according to a particular locale-
and/or platform-specific character encoding, and writes those
bytes to the specified <tt CLASS=literal>OutputStream</tt>.  This is a very
important internationalization feature in Java 1.1.

<P CLASS=para>
When you create an <tt CLASS=literal>OutputStreamWriter</tt>, you specify
the <tt CLASS=literal>OutputStream</tt> to which it writes bytes, and
you optionally specify the name of the character encoding
that should be used to convert characters to bytes.  If you
do not specify an encoding name, the
<tt CLASS=literal>OutputStreamWriter</tt> uses the default encoding of
the default locale, which is usually the correct thing to
do.

<P CLASS=para>
<tt CLASS=literal>OutputStreamWriter</tt> supports the usual <tt CLASS=literal>Writer</tt>
methods.  It also has a <tt CLASS=literal>getEncoding()</tt> method which
returns the name of the encoding being used to convert
characters to bytes.

<DIV CLASS=screen>
<P>
<PRE>
public class <tt CLASS=literal>OutputStreamWriter</tt> extends Writer {
    // <tt CLASS=literal>Public Constructors</tt>
            public <tt CLASS=literal>OutputStreamWriter</tt>(OutputStream <tt CLASS=literal>out</tt>, String <tt CLASS=literal>enc</tt>) throws UnsupportedEncodingException;
            public <tt CLASS=literal>OutputStreamWriter</tt>(OutputStream <tt CLASS=literal>out</tt>);
    // <tt CLASS=literal>Public Instance Methods</tt>
            public void <tt CLASS=literal>close</tt>() throws IOException;  //<tt CLASS=literal> Defines Writer</tt>
            public void <tt CLASS=literal>flush</tt>() throws IOException;  //<tt CLASS=literal> Defines Writer</tt>
            public String <tt CLASS=literal>getEncoding</tt>();
            public void <tt CLASS=literal>write</tt>(int <tt CLASS=literal>c</tt>) throws IOException;  //<tt CLASS=literal> Overrides Writer</tt>
            public void <tt CLASS=literal>write</tt>(char[] <tt CLASS=literal>cbuf</tt>, int <tt CLASS=literal>off</tt>, int <tt CLASS=literal>len</tt>) throws IOException;  //<tt CLASS=literal> Defines Writer</tt>
            public void <tt CLASS=literal>write</tt>(String <tt CLASS=literal>str</tt>, int <tt CLASS=literal>off</tt>, int <tt CLASS=literal>len</tt>) throws IOException;  //<tt CLASS=literal> Overrides Writer</tt>
}
</PRE>
</DIV>

</DIV>

<DIV CLASS=sect2>
<h3 CLASS=sect2><A CLASS="TITLE" NAME="JNUT2-CH-24-SECT-47.2">Hierarchy:</A></h3>

<P CLASS=para>
Object->Writer->OutputStreamWriter

</DIV>

<DIV CLASS=sect2>
<h3 CLASS=sect2><A CLASS="TITLE" NAME="JNUT2-CH-24-SECT-47.3">Extended By:</A></h3>

<P CLASS=para>
FileWriter

</DIV>

</DIV>


<DIV CLASS=htmlnav>

<P>
<HR align=left width=515>
<table width=515 border=0 cellpadding=0 cellspacing=0>
<tr>
<td width=172 align=left valign=top><A HREF="ch24_46.htm"><IMG SRC="gifs/txtpreva.gif" ALT="Previous" border=0></A></td>
<td width=171 align=center valign=top><a href="index.htm"><img src='gifs/txthome.gif' border=0 alt='Home'></a></td>
<td width=172 align=right valign=top><A HREF="ch24_48.htm"><IMG SRC="gifs/txtnexta.gif" ALT="Next" border=0></A></td>
</tr>
<tr>
<td width=172 align=left valign=top>java.io.OutputStream (JDK 1.0)</td>
<td width=171 align=center valign=top><a href="index/idx_0.htm"><img src='gifs/index.gif' alt='Book Index' border=0></a></td>
<td width=172 align=right valign=top>java.io.PipedInputStream (JDK 1.0)</td>
</tr>
</table>
<hr align=left width=515>

<IMG SRC="gifs/smnavbar.gif" USEMAP="#map" BORDER=0> 
<MAP NAME="map"> 
<AREA SHAPE=RECT COORDS="0,0,108,15" HREF="../javanut/index.htm"
alt="Java in a Nutshell"> 
<AREA SHAPE=RECT COORDS="109,0,200,15" HREF="../langref/index.htm" 
alt="Java Language Reference"> 
<AREA SHAPE=RECT COORDS="203,0,290,15" HREF="../awt/index.htm" 
alt="Java AWT"> 
<AREA SHAPE=RECT COORDS="291,0,419,15" HREF="../fclass/index.htm" 
alt="Java Fundamental Classes"> 
<AREA SHAPE=RECT COORDS="421,0,514,15" HREF="../exp/index.htm" 
alt="Exploring Java"> 
</MAP>
</DIV>

</BODY>
</HTML>
